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May I have your attention, please? 

It's ail Don Lancaster's feult I suppose I have some responsibility as well, 
but it was his idea. To quote from his seminal woiK The Incredible Secret 
Money Machine 

Employees are a hassle, a waste of time and money and a psycfUc energy 
sink. You should avoid them at all costs. 

Your incredible secret money machine should have 0.854 employees— 
that is 85A per cent of you, nothing more, no iess. The remaining 16.6 per 
cent of you should go for fun and rewind time. 

Unfortunately, Open-Apple has been taking up about 834 per cent of my 
time. So I went back and reread what Lancaster suggests people like me do. 
rind others whose money machines are up and working and use them to do 
the things you can't handle yourself he says. 

Lancaster's book was my primary instruction manual for starting Open- 
Apple. (Avery good manual it is, too -highly recommended for those of you 
who are in business for yourself or who are thinking about starting up 
something. It's a mere $7.50 from Synergetics, Box 809, Thatcher, AZ 85552 
602-428-4073.) My only serious problems have come in areas where I didn't 
follow his advice. So a couple of months ago 1 decided it was time to start 
working less. 

Another address. The sad, sad consequence of all this is tiiat Open- 
Apple's subscription records are no longer kept on an Apple 11. Your names, 
addresses, and expiration dates were transferred to 9-track mag tape this 
month and are now sorted and batch processed on a McDonnell-Douglas 
minicomputer running the Pick Operating System. 

1 want to make it perfectly clear that the limiting factor around here was 
me. The Apple 1 1 I've been keeping your records on had plenty of capacity left 
(until this month your names and addresses were stored in a huge 
AppleWorks file on a He with 1 megabyte of memory, a 10 megabyte hard 
disk, and an accelerator card). This system and one ftill-time person could 
handle a subscription list three or four times larger than what Open-Apple 
now has (that would be 12 to 16 thousand names). But I'm the only full-time 
person around, and I have newsletters to write. 

The folks r chose to handle Open-Apple's subscription fulfillment 
specialize in fast accurate work for small publications. They come to us with 
high recommendations. Sally T^lly, our new circulation manager, promises 
improvements over the rather uneven level of customer service I've been 
able to provide you myself (some weeks 1 was real good; other weeks I was 
tenible), even tiiough she has to use a minicomputer rather tiian an Apple II. 

Because of this change, Open-Apple has a new post office box for all 
subscription-related correspondence, such as new orders, payments, and 
changes of address. It is: 

Open-J^ple Qur main subsGrlptian address 

P.O. Box 6331 
Syracuse, NV 13217 

We also have new invoice and renewal forms — for the most part tiiey look 
like the ones real magazines use. Whenever you get one of these you'll also 
get an envelope, with our new address printed on it to send it back in. 

Abby, the little lady who used to urge you buy a multi-year subscription 
from the inside flap of our remittance envelope, reached Open-Apple's 
mandatory retirement age of 95 and is now working behind the counter at 
McDonald's. She may make some purety promotional appearances for us in 
the future, however. 



Of course, none of tiiis applies to those of you in Australia and new 
Zealand, but just to keep tilings consistent we have a change of address for 
you, too. Our circulation manager in your earth-qua<^ant is: 



Kerf'y iransdn 

c/p Cybernetic Research Ltd 
57G flalyern Road 

Prahran, Victoria 31B1 RUSTRflLIfl 



Our southerfi subscription address 



Uncle DOS and I still live here in Kansas City, or, more precisely: 



P.D. Box ?G51 
Overland Park, 



Our editorial address, uorld-uiide 



KS G6207 



Another Uncle DOS. The role of Uncle DOS is now often played by Dennis 
Doms, whose name has been appearing more and more regularly in ttie 
letters section of this newsletter. Dennis is a writer and certified Apple hacker 
who has been answering Apple questions from local user group members, 
electronically and in person, for years. He has now started his own litUe 
sideline answering most of the mail we get around here. He tiiinks its 
wonderful to get paid to answer Apple questions, and I think it's wonderful to 
get tiiese stacks of paper off my desk, and you, 1 hope, think it's wonderful to 
have someone to write to about your problems who will actually write you 
back. Keep those cards and letters rolling in folks. Unde DOS loves tiiem. 

A bound volume of OpewApple's first 13 issues —January 1985 through 
January 1986, inclusive — is now available. Our index appears on the covers. 
It sells for $14.95. 1 still have single copies of all back issues for $2 each, I 
have also decided to start selling the DOStalk ScrapbooK by me and Bert 
Kersey for $14.95. There's a program disk tiiat goes witii tiiat book for $10. 
We have a tiiird book that will be officially announced in a moment if 1 don't 
forget again this montii. 

Book prices include surface delivery anywhere in the world; for airmail outside Worth 
America add $1 per order plus $4 per book. Book and back issue orders wilt be handled 
fastest if you send them to our Syracuse address, though we'll eventually fifl your order 
no matter how you get it to us. 
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1 I Concrete reqoirenent estimator, 

2 I For new shop building. 

3 I 

4 I Concrete required: 32.3? cubic yards 



FORMULAS 
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Figure 1 
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Concrete requirenient estinator. 
For new shop building. 



FORMULAS 
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Length <4eet): 
Midth (4tet): 
Depth (inches)! 
Concrete required: 32,37 cubic yards 



Ha in East & North & 
Floor Uest South 
Pad Footings Footings 
56 49 .8 It. 
30 .8 28.5 ft. 
6 \2 12 in. 



((C7«C8«(C9/l2»X2»&7«D8»(D?/12))X2«E7iE8«<£9/12»V27 



Figure 2 



Anc^r book. According to the March 1986 issue of ^ple Assembly 
Une. lorn Weishaar {^ids. thatfs me!) Im witten a new book called Your 
Best talmst; A Ploncy Book fw tiw Compu to 
I've fofgotten to mention this book here in Open'Apple for two moniis 
running doesn't mean ttiat I'm nc^ proud of it I'm just easily distractable, 
that's alL 

1 wrote Your Best Interest during the summer and early fall of 1984, in 
between the death of So/iaifcand the birth of Open-Apple. However, it's just 
hitting the bookstores now It's the only computer-related piece I've done 
that isn't specifically related to the Apple II. The book is about interest rates 
(how to calculate the "time value of money" using a spreadsheet program) 
and related stuff (death, taxes, inflation, and deception mostly). 

Since my own opinion of the book is highly biased (I think it's the best 
piece of work I've ever done), let me provide you with a second opinion. Here 
are the most complimentaiy parts d Bob Sander-CederioTs review in Af^e 
Assembly Line 

VmrBeU lideresi im't abouiApfHe assemb^ iangu^e, but i cannot 
resist letting you s^ut it anymy. 

The bm^k is about interest rates—hotii to understand Otem, horn to 
a^adate (Item, hoif^ they affect yow !t ummrttten for people uaho know 
how to use a spreadsheet program. Ml Qm hard math and books of tables 
are replaced by your favorUe aic-sMe. , . , 

5ei;en /ascinattng chapters teadj^u to an undeistand&ig ofhowfimKM 
transactions really work. . . . 

have you thought about buying a house recently? Tom shows you how 
to figure the true cost of an adjustable-rate mortgage, how to compare 
different fmancing schemes, and how to protect your money. You'll learn 
about the tricks the money lenders sometimes use to take advantage of 
unwary investors and borrowers. And all is tied to spreadsheet models you 
can put into your Apple. I wish I had only known how to do these things 
when 1 bought a pickup truck last summer. Or leased a copying machine 
three years ago. And when we bought some land in the country.. . . 

The book is published by InfoBooks of Santa Monica, Calif. You can get it at 
your local bookstore (some have it vdth the computer books, some iiltti the 
business books) or you can order it from Open-Apple for $9.95, postpaid 

I haven't talked much about spreadsheets in Qpefi-Apjiie, but it's not 
because I don't use them. Your Best Interest revolves around spreadsheet 
programs. 

One of the greatest limitations of today's spreadsheet sofh^re is that 
users think of it only in the context of financial calculations. In fact a 
spreadsheet is ideal for number crunching problems in the areas of 
spelunking, nursing diagnosis, and space exploration as well. One of the first 
magazines to recognize this and to consistently emphasize it is called 
AgriComp It covers the area where computers and agriculture overlap ($24/ 
year, 103 Outdoors BIdg, Columbia* NO 65201). 



Since I've been busy this month hand-aanking 9-tiack tape through my 
UniDisk, I got AgnCbmp'spennis^n toshowyoufiiefoUoi^artkie, whkii 
is one d the best I've ever seen on pradlcai ^sreadsheet use& 

The Ad Hoc Spreadsheet 

byNarklHlsdorf 
Copyright 1086 by AgriCon^ 

Ad hoc is a Latin phrase meaning "to this." In today's language, "ad hoc" is 
normally used to denote something aeated or established for a particular 
purpose (to this purpose). We often think of the thing established as being 
temporary^ An ad hoc committee is a committee establi^ed for a particular, 
special purpose; oft^ ti^ idea that the committee will be disbanded 
when its job is completed 

Anadhoc$prea(teheetisoneyousetuptodosomeone-timejob,notajob 
that you plan to do apin and again. Most of us piece together an ad hoc 
spreadsheet as if we were a 10-year-oId making a tree house— plenty of 
ideas and imagination but not a lot of planning. You don't want to spend too 
much time planning and building the spreadsheet because you might only 
use it one time, to find one answer. But with just a little planning— or by 
developing a few good habits for building spreadsheets — thejob of building 
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the spreadsheet will be faster and easier. And if you do store a copy of the 
sfxe^heet on disk for possible later use, a bit of planning and documentation 
wU make it much easier to reuse at a later date. 

Consider the example of estimating how many cubic yards of concrete are 
required for the foundation of a grain bin or other building you are 
consbTJcting. Every situation is different enough (circular versus rectangular 
area, level or unlevel surface, different footing depths, etc) that you almost 
need a completely different spreadsheet each time you do conaete work. 

However, witii litOe additional effort you can create a spreadsheet that will 
calculate the answers you want without requiring much of your time for 
spreadsheet development that will produce a well-labeled printout (one tiiat 
taill still make sense if your work gets put off for a couple of weeks), and that 
wU potentially be useful in otiier similar situations— in case you need to 
estimate some conaete requirements again next year. 
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FORMULAS 



Length iUt\)t 
Width (fKt): 
Depth (inches): 

CALCaATlONS; 
Pad: 

East or wst footing: 
North or iooth -footing: 

RESULTS: 
Concrete reqiBired: 



Haiii East & North & 
floor Uest South 
Pad footings Footings 



50 
36 
6 



49 



I ft. 
28.5 ft. 
12 if). 



27.78 cubic yards 
1.45 cubic yards 
.84 cubic yards 



32 J? cab ic yards 

Figures 



(C8»C9*(C10y'l2))/27 
(D8»09»<D10/12)>/27 
(E8«E9i(E10/12))/27 



*W3+<2«5J4)+(2«M5) 



< A X 6 X C X D >^ E 

/// Concrete ReQuifeneut Estinator 
/// for new sliop building. 
/// Prepared 09-A«9-85 

DATA: 



\\\ 
\\\ 
\\\ 



F R H U L A S 





Ha i n 


Eifrt 4 Hor lfi 4 






^loor 


West South 






Pad 


footings Footings 




Length (feet): 


50 


49 .8 ieet 




Uidth (feet): 


30 


.8 28.5 feet 




Depth (inches): 


i 


12 12 inches 




CALCUU^TIflNS: 








Padt 




27.78 cubic yards 


(C9«C16»(Cn/]2})/2? 


East or west footing: 




1.45 cubic yards 


(D9»O10«(Dll/12»/27 


North or south footing: 


.84 cubic yards 


fE9»Eie«(Ell/12»/27 


RESULTS: 








Concrete required; 




32.37 cubic yards 


+015t(2fDU)K2«Dl7) 






Figure 4 
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/// Concrete Requirwtnt Estimator V\\ 

/// For: 24" Brain Bin V\\ 

//'/ Prepared 09-Aug-85 Wn 

/// \\\ 

/// REMARKS: Moiuiie of concrete in footing is \\\ 

/J/ calculated by subtracting volume of the \\\ 

/// cylinder represented by the inner wall of \\n 

/// footing, froB the volume of the cylinder V\\ 

/// represeoted by the outer wall o^ footing. VW 



FORMULAS 



DATA: 




Inner 


Outer 






Main 


Uall 


Uall 






Floor 


of 


of 






Pad 


Footing 


Footing 




Diameter (feet): 


25.5 


24.33 


25 feet 




Depth (inches): 


6 


18 


18 inches 




CALCUiATJflNS: 










Pad: 




cubic yards 


(»]«Ciy2)*2*(C16/12))/27 


Inner wall cyl . volu 


me: 


25.83 cubic yards 


(3PI»(D15/2)*2*(016/12))/27 


Outer wall cyl. volune: 


27.2? cubic yards 


(3P]»(EI5/2)'2«(E16/12))/27 



RESULTS: 
Concrete required: 



1S,?0 cubic yards 

Figures 



+D20XD22-D21) 



Here's a list of good habits to cultivate that will make your ad hoc 
spreadsheet development time more productive. 

rut a descriptive label at the top of the spreadsheet Your label 
doesn't need to be eitiier long or fancyjust something that will immediately 
identify the spreadsheet's purpose when you load it into your computer or 
see it printed out 

Whenever possible, put each piece of data in a separate cell that b 
labeled with names and units of measurement. When you begin to 
assemble die data you need for a simple spreadsheet it may be unclear how 
all of the data will be used. Labeling the data and placing it in separate cells 
will allow easier access as you build formulas— and will assure tiiat your 
printouts show what data was used in calculating the results. Compare 
Rgure X where the data is all lumped together in a formula, witii Figure 2, 
which has all data separately entered and labeled. Which spreadsheet 
printout would you have more confidence in if you looked at them again one 
week from today? 

If possible, reserve one area of the spreadsheet for nothing but 
data. Use a separate area for calculations and possibly even a third 
area for final results. Have you ever looked at a spreadsheet printout and 
wondered whether a number had been entered as data or was calculated by 
a formula? Don't allow "aeeping confusion" to take over your spreads^^^pt 
as it grows larger Divide your template into areas with different ftinctic. 
avoid potential problems— including accidental erasure of formulp 
confusion over what data was used, ease of conversion to similar problei 
and so on. 

You mayalso want to consider dividing your formulas into smaller chunk 
as done in Figure 3. Shorter formulas are easier to decipher than a single 
long formula, such as tiie one used in Figure 2. 

Don't spend much time sprucing up your spreadsheet until you are 
mostly done with it and unless you are likely to use it again later. One 

common waste of time during spreadsheet development is in trying to keep 
a template looking "perfect' in early stages of development All the work you 
put into centering titles and drawing borders and fanc^ labels will be wasted 
if you later find that your spreadsheet requires wider columns or a change in 
structure. 

For example, you might realize after the spreadsheet is finished that it 
could be printed on a single sheet of paper with a few modifications. Only 
when you are fairly sure of your spreadsheet's final form should you invest 
much time in "prettying up" its appearance — and then only ifyou will use the 
spreadsheet frequentiy enough to justify the investment of your time. 

Save a permanent copy of the spreadsheet on a disk when you're 
finished with the job. You may want to go back later and check your 
calculations for errors. Or you may decide to do the job a bit differentiy— 
such as increasing the depth of the concrete footing— and you'll need to go 
back and change some data. Without a disk copy of your spreadsheet you'll 
have to go through tiie whole development process again. 

Other times, the need to do a similar job may pop up sooner than you 
expected. I deleted a disk copy of a spreadsheet for figuring a grain bin pad 
one fall, only to put up another bin of tiie same dimensions the following fall. 
It's a good idea to keep a disk or two of such miscellaneous spreadsheets. 
Often just a few changes are all that is needed to rework an old spreadsheet 
for a new situation. Figure 5 shows a spreadsheet for figuring concrete needs 
for a grain bin pad, which was developed by reworking the spreadsheet in 
Figure 4. 

No AppleWorks @PI 

If you try to type AgriComp's Figure 5 into an AppleWorks spreadsheet 
you'll make the amazing discovery tiiat AppleWorks has no ®?\ ftinction. It's 
also missing @LOQ10, which is used a couple of times in Your Best Interest 

This discovery led me to do a quick comparison of tiie functions available 
in the five spreadsheet programs I have at my fingertips. They include two 
DOS 3.3 programs— the original DOS 3,3 version of VisiCalc and MCca/c 
(\^ich also goes by the names The Spreadsheet and Afag/Cate). ProDOS 
entries were MouseCaic SuperCalc, and AppleWorks. 

All five include the following functions: ABS(olute value), AVERAGE, COUFIT, 
ERROR, IF, iriT(eger), LOOKUP, MAX(imum), Miri(imum), m(mt available), 
SQRT(square root), and SUM. 

All but SuperCalc have a CHOOSE function; all but MouseCalc have 
riFV(net present value ). 
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All but AppleWorks have EXP{e to a power), Unnatural log), LOGIO, PI, AMD, 
OR, nOX TRUE, and FALSE. 

AppleWDrks and MouseCa/care both missing ISERRORand ISm. AppleWal^ 
and VisiCaicare missing ROUND. AppleWorks, VisiCsdc, and Si^erCafcareall 
missing ROW and COLUMn, 

Only VisiCalcaM SuperCa/chave Siri(e),GOS(ine),TAn(gent),ASiri,ACOS, 
andATAM. 

Only SuperCalc has MOD, RAWDOM, four additional financial functions, 
eight date functions, ISDATE, ISnUM. and ISTEXT. SuperCalc also allows text 
'Values." 

Only SwperCaicand MouseCafcwiH draw graphs of your spreadsheet 
Only SuperCalc and AppleWorks are unprotected and can be moved to a 
hard disk. 

As you can see, AppleWorks is missing lots of functions available with the 
other four packages. On the other hand, only AppleWorks has a spreadsheet 
larger than 60 columns by 256 rows. AppleWorks allows 127 columns by 999 
rows. This isn't quite as wonderful as it seems, however, because only 60 cells 
on any single row can hold a formula, but it still beats the pants off the other 
four. 

As a test, I recently made two very large spreadsheets using AppleWorks 
and Applied Engineering's desktop expansion software. In each cell 1 put a 
simple formula that added 1 to the value in the cell just above or to the left 
One B1Q.SHEET was 60 columns by 256 rows- the total capacifyof the other 
spreadsheets— it used 387K and took four minutes to recalculate. My 
second B1G.SHEET was 60 columns by 999 rows — the AppleWorks maximum 
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for formula-holding cells— it used 673K and took 6 minutes to recalculate. 
Of course, if you used more complex formulas your spreadsheet would use 
even more memory and take even longer to recalculate— but it can be done 
if you want to do it Incidentally, those recalculation times are unaccelerated, 
A speed-up card would probably cut them in half. 

I'm not satisfied with any of these five spreadsheets. Because I'm often 
running AppleWorks an^ow, I usually use its spreadsheet when I need to 
crunch some numbers, but I'm dismayed at the paltiy selection of math 
functions it offers. My second choice is MCalc It is a definite improvement 
over the older VlsiCalc disk 1 have, with features such as eighty-column 
display, recognition of most memory cards (it gives me a 280K workarea on 
my 1 megabyte Apple), and automatic splitting of wide spreadsheets into 
pages when printing. 

SuperCalc has possiblities. It is clearly the powerhouse here, but comes 
with a CP/M-style user-interface thafs foreign to anything else I use. It 
reminds me of the shock of arriving in Portuguese-speaking Brazil after 
traveling tiirough Spanish-speaking areas of South America. Armed with my 
high-school Spanish, 1 can eventually figure out the system in places such as 
Peru and Bolivia. In Brazil and in SuperCafc, however, I am totally lost I can't 
even change money Those of you who really need SuperCalds additional 
powers may find it worthwhile to spend the time it will take to learn how to 
use it 1 haven't been able to justify the investment 

MouseCalc, as I have mentioned here before, scrolls so slowly it has no 
practical value. Thafs too bad, because othenArtse it has possiblities. 




The Orange Squeezer Mod 

byTomVier 

Letters in the December (page 95) and January (page 101 ) issues of Open- 
Apple document a serious problem with Orange Micro's internal printer 
buffers. These devices capture what you send to your printer at machine- 
language speed. Then they spoon feed the data to your printer at a rate it can 
keep up with. Your Apple itself can also spoon feed a printer, of course, but 
without a printer buffer it can't attend to botfi you and the printer at the same 
time. With a buffer, you and your Apple can go back to word or data 
processing while your printer and the buffer clunk away 

Orange Micro sells two versions of its printer buffers. The Buffered 
Qrappler-Plus is both a printer interfece card and a buffer. The Bufferboard is 
a slot-resident device that requires a separate printer interface card. These 
boards are less expensive and less cluttering than external printer buffers, 
which demand a power outlet and desk space somewhere between your 
computer and your printer. 

Orange Micro's slot-resident buffers, however, have one major dra\irf)ack. 
They lack a switch to flush the buffer. If you tell your Apple to begin printing a 
long document and then realize you forgot to specify that you wanted the 
document double-spaced, for example, you need a way to tell the buffer to 
stop printing and throw its contents away The flush-buffer signal that the 
Grappler boards use is an extended press of the reset key 

Unfortunately a lot of software, including AppleWorks, won't tolerate this. If 
you press reset ft^om within AppleWorks, you'll send the data on your 
desktop, as well as the data in the printer buffer, right on down the old 
porcelain convenience. Thus a simple desire to terminate printing can 
become a disaster. 

Fortunately there's a cure for this. We can install our own flush-buffer 
switch on Orange Micro's boards. It's very simple and very easy All that is 
required is a little push button and a couple of lengths of small-gauge solid 
wire. The push button needs to be a normally-open, momentary type. The 
only tools you'll need are a wire cutter and a soldering pencil. The soldering 



pencil doesn't even need to touch the board unless you want to make the 
switch permanent 

Orange Miao uses the 8048 miaocomputer chip to control its buffer 
boards. This chip has its own internal RAM, ROM and microprocessor. The 
8048 monitors the Apple's reset signal through one of its I/O lines. It would 
be difficult to get the 8048 to flush the buffer by altering the signal on this 
line, however, because it would require extra isolation to prevent resetting 
the Apple's 6502 as well. 

A much easier solution is to use the 8048's own reset line, which is 
available at pin 4. Pulling this line to a low voltage simulates a power-up and 
will clear the buffer immediately To pull the line low all we have to do is to 
connect it to ground —conveniently available at pin 20 of the 8048. Our 
flush-buffer switch simply connects these pins together when the button is 
pushed. 

First attach the wires you'll be using to your push-button switch. TWist the 
wires together and cut them long enough so that you can place the switch in 
a convenient location. How remove your card (eittier version, they are very 
similar) and place it before you, component side up, oriented as in the 
accompanying illustration. Locate the chip shown. Ifs hard to miss, since if s 
the biggest guy on the block. Remove the insulation from the tips of the wires 
and carefully insert one into the socket at pin 4 and the other into the socket 
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at pin 20. Do tiiis with the chip in place— you don't even need to remove it 
Make sure tfiere is no bare wire exposed and your project is finished. 

Optionally, if you want to make this installation permanent solder the 
wires to the leads of capacitor C9 on the back side of the card. It's just above 
the 8048 (UIO), as shown in the diagram. It also wouldn't hurt to put a .01 uf 
bypass capacitor across the leads of C9 to get rid of any noise the wires pick 
up. Put the card back in your Apple and run the switch out to a handy 
location. 

Once installed, this switch makes it easy to stop a runaway document 
First get your program to stop printing, if it hasn't already With many 
programs, including AppleWorks and Apple Writer, you do this by pressing 
the escape key next press the flush-buffer switch to clear the buffer. Printing 
might not halt immediately because some printers also have small internal 
buffers. Tliming off the printer will stop that cold. 
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April Fool is past 

Was "Soft write-protect tabs" {April, page 2.23) an 
April Poors joke, or is there something very different 
about the I Ic disk hardware? Th^ pokes will certainly 
blind DOS to the state of the write-protect switch, but 
they won't fool any self-respecting drive that I know of. 

Michael Qruenthal 
Durham, Calif. 

The jofce was on me. As many, many of you have 
noticed, those pokes only SEEN to work— the drive 
makes all the right noises and stuff —but nothing 
actually gets written onto the write-protected disk. I 
wondered why I had never read about those pokes 
anywhere else before. The genie in the machine 
really got me good Ih^ ymi Btd 111 get even next 
April (look, your mouse is loose, etc) 

A poke from Australia 

After saying that writers must "understand words 
and . . . spell them correctly" (January 1986, page 97), 
you mentioned that Bremner was Austrfalian bom. Is 
that anywhere near v^ere I live? 

I checked my Uc as you described on page 99 and \ 
don't have the new miniassembler. Is there an old 
one? 

Adrian Gallagher 
Kanahooka, Australia 

A liUle over 10 years ago I spent an afternoon 
sitting in front of five cranky Uruversity of Kansas 
professors. The occasion u;as an oral examination 
for a masters degree in Journalism. Did they ask me 
about Walter Lippmann's influence on American 
Jounmlism? Ho, they asked me how to spell Walter 
Ulppnmn, Clivo p's/'/said. How many 'n's"they 
asfced "One?" / said. "Shame, Mr. Mfeishaar/' they 
said.) 

Then Prof, bremnei in his feooming oofce, said 
Mr. Mfeishaar, In yom master's thesisyou misspelled 
the word vegetalAe' twenty-one times. Could you 
please speM 'vegetable' for us?"Ia)uldnt 

Should I go on? They did. It was like third grade. (I 
just wanted you to know that this isn't the first time 
I've had to take abuse about my spelling from an 
Australian.} 

To get to the old miniassembler, you need a DOS 
5.3 System Master disk. Boot it When you see the 
Applesoft prompt, enter the command lliT. This will 
put you into Integer Basic (the prompt will change to 
a greater-than sign). Then do a CALL -15X and a 
f666G. This gets you to the ! prompt of the old 
miniassembler From there, enter a starting address, 
a colon, a space, an assembly language mnemonic, 
and, if required by the instmcUon, an address. The 
mtnlassembler will translate the mnemonic and 



address into machine code and piace the correct 
numbers at the address you have specified. 

Begin the next line with a space rather than uAth 
the address and colon. This will put that line's 
machine code right a/ler the /irst tine's. You can enter 
Monitor commands (M rriiniasseml>ier only) by 
beginning the line uMh a dottar sign. Exit the old 
miniassembler with a $5D0G (for Basic! or $IT69G 
(for the Monitor). (You can exit the new miniassembler 
by pressing return on an empty line.) 

Power supplies and track 

I recently added a Si der hard disk to an enhanced 
Apple lie system that had been hawng the ProDOS 
track crash problems several users have written 
about in Open-Apple (January 1986, page 103; 
February page 2.6; March, page 2.12), 

With the Sider, the computer would reboot when I 
attempted to save a file to the hard disk. The file 
being saved would be destroyed or, in some cases, 
changed into a monster file. In one instance, a new, 
two-item AppleWorks database file was transformed 
into something too large to load into my 275K 
desktop. If I happened to be saving to a floppy, the old 
eat track syndrome surfaced ag^in. 

I discussed the problem with Urst Class Peripherals. 
A technician there told me that most of the problems 
customers had experienced with the Sider were 
solved by replacing the^pte's power supply with one 
sold by Jameco Elcdionics for $39.95 (1355 Shoreway 
Rd, Belmont CA 94002 415-592-8097). He said that 
Apple procured its power supplies fi'om several 
sources in Asia and at least one of these suppliers 
seemed to have a quality control problem. (That 
would explain why only some enhanced lies are 
having track problems.) 

I purchased the new power supply, installed it in 
about ten minutes, and have not experienced any 
problems since then. 1 have left the computer on for 
prolonged periods, repeatedly saved the same (ex- 
pendable) file to hard disk and floppy and have had 
no crashes. I will leave it up to the technicians to 
explain why the power fluctuation resulted in the 
problems 1 experienced, but the bottom line is that 
$39.95 soh/ed all my probl^ns. 

One final note: I wrote Apple on January 7. 1986 to 
desaibe the problem I was ha^ng. Thus fiar I have not 
recdved any response, not even an acknowledgement 
Of a word of sympathy, much less any suggestion as to 
how to soNe the problem. 

I hope this will be of help to some of your readers. 

John W. Patterson 
Richmond, 

This is a follow up to my two letters concerning the 
track aash problem (January 1986, page 103; 
March, page 212). It may be solved. Our school has 
been informed that although Apple has not been 
able to find any problems with the two computers of 
ours that ware sent to Califcmiia, they would replace 
all 20 of our power supplies. 

I hope this takes care of it but the new power 
supplies haven'tbeen installed yet so I'm notsure. Ill 
let you know Thanks for your help, 

J. Ernest Cooper 
Lathrup Village, Mich. 

The pieces of this puzzle are beginning to fail into 
piace. If the track crash problem is related to bad 
power supplies, that would explain why it is seen 
only in the newer enhanced lie. It isn't the enhanced 
^us of the machine that's causing the problem, but 



last summer's change in Apple lie manufacturing 
facilities. uMch was probably accompanied by a 
change in component suppliers (July issue, page 
49). 

The power supply is the large metai box inside 
your U'Pius or He. It is held in place by four screws 
accessible from the bottom of the computer The 
compiler's on-off switch and AC-power connector 
are also built into the metal box. The switch and 
connector are accessible from outside the computer 
because of a strategic hole In the case that allows 
them to poke through. Inside the computer, a set of 
sk wires comes out of the power supply and termi- 
nates in a single connector that plugs into the 
motherboard. 

Replacing the power supply is only a little harder 
than dianging a light bulb. Remove theAC<ord and 
the four screws. Lift out the supply. Squeeze the 
mMerboard connector and pull it free. You may 
need to remove a card to get a good grip on the 
connector. Reverse this procedure to put a new 
supply back in. The hardest part is lining up the 
screw holes on the new supply. 

Apple's power-supply specifications for Horth 
American computers calf for the supply to perform 
adequately as long as the input AC power is within 
the range of 107 to 152 volts. The power supply 
provides the computer with four voltage levels. 
According to the Addison-l/i^sley edition of the 
Applelle Technical Reference Manual (page 159), 
the power supply is designed to perform at the 
f(Mowing spedficatfons: 

naminal true naxlfflum 

voltage volta^ current 

+ 5V ^ 5V plus/nlnug 2% 2.5 amps 

+i2V +U.8V pius/ffiinus &L l.S / Z.5 an^s * 

- SV - 5.2V pius/fliinus .25 amps 

-12V -12V plus/minus 10» .25 amps 

* The +12V source can proyide 2.5 amps intermittent- 
ly. Intermittent operation is considered to be 
up to 26 minutes at the higher load If foUoued 
by at Ira^t 10 minutes at the norma 1 load, 
MaKimum pouer consusiption of the power supply as 
a yhole is 60 uatts continuous, 89 uatts 
intermittent. 

TTie Fall 1980 issue of Apple Orchard had an 
article called ' Don 't Overload Your Apple IT' by Ken 
Silverman (page 67). The article lists a number of 
peripherals that obtain their power from the Apple 
(by means of the slot connectors) and the amount of 
+5Vand + 12V current used by each peripheral when 
off and when in use. 

AlthoughmearUdeissomewhatdated. thedeoice 
that puts the most load on the +12V supply is still 
pret^common—5-l/4inchfloppydrives. ^Iverman 
saj/s an acttue drive uses about .425 amps o/+i2l^ 
current. However, during the first second or so, while 
bringing the disk up to speed, a drive will draw about 
. 7 amps, Silverman says. This is more than a quarter 
of the intermittant +12V power available from a 
normal Apple power supply. 

If that much power isn't available because of a 
weak power supply, the rate at which the disk comes 
up to speed could be too slow. Another possibility is 
that drive speed could be erratic. Data written to the 
disk under these conditions could easily be unread- 
able later. 

But why does the track problem seem to occur 
only with ProDOS? I suspect the culprit here is the 
machine language code ProDOS uses when starting 
up a disk. It's different from that used by DOS 3.3. In 
DOS 3.3, the motor is started and Rms wsdts a 
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specific period for the motor to come up to speed. 
The wait is determined by a byte called the "motor- 
on time count" This byte is defined in the ' Device 
Characteristics Table" which itself is an attachment 
to the Input/Output Control dlocK or iOd. used by 
the RWrs routine. 

In standard DOS 3.3, the motor-on time count is 
stored st$B7FE. Itisnormally$DS(216).Justforfun, 
start up DOS 3.3 and do a few CATALOGS. Pay close 
attention to how long it takes from the moment you 
press return until the catalog begins to appear on 
your screen. Then POtiE 4710Z0, This will change 
the motor-on time count to zero. Do some more 
catalogs. Hotice how muchfasterthe catalog appears 
on your screen? 

You gain the additional speed by eliminating the 
motor-on wait DOS begins trying to read the disk 
immediately. As soon as the disk is spinning fast 
enough to get readable data, DOS uMl grab the 
catalog. 

noweoer, don't try to make this poke a per- 
maneittpartof DOS. When reading, an error caused 
by erratic disk speed isn't critical The data associated 
with the error is thrown out and DOS tries to read the 
sector again. Uncle DOS doesn't throw up his hands 
and yell //O ERROR untaseueral unsucces^ attempts 
to read the sector haoe been made. 

When writing, on the other hand, no check is made 
to see if the sector written is ualid. flo retries are euer 
made. Thus, a write that occurs before the disk 
speed has settled would be unreadable, but you 
wouldn't find out till you tried to use that sector 
again, later. 

Asnoted, theProi)OSmotor<!elayc(xlei$differeni 
from DOS 5.5's, however, it functions In a similar 
manner. The drive motor is started and a timing loop 
causes a delay. Once the delay is over, ProDOS 
checks the data port for changing data. // the data 
changes, it assumes the disk is ready and proceeds 
to attempt the read or write. If the data has not 
changed after 255 comparisons, ProDOS sends an 
//O error. 

Because of the complexity of the code, / can't 
easily proue that the ProDOS motor-on delay is 
shorter than DOS 3.3's. In fact, based on the speed at 
which a catalog appears on the screen, DOS 3.3 
appears to be the zippier of the two. But I suspect 
that some subtle difference in the coding makes a 
disk not yet fully settled at the correct speed look ok 
to ProDOS, while DOS 3.3, for whateuer reason, 
giues the disk more time. 

Why track 0? This is where ProDOS keeps a disk's 
root directory and free sedor map. The blocks on 
track are constantly being rewritten. They get far 
more use than any other blocks on a disk. DOS 5.5's 
catalog is in track 17 f$U). If the power-supply 
problem was going to occur with DOS 3.3, it would 
probably be track 17 mat got destroyed, rather than 
track 0. 

It may also be significant that track is the 
outermost and thus longest track on a disk. The 
magnetic media normally passes by the disk head 
faster when the head is on this track than on any 
other. This may amplify the effect of erratic disk 
speed, and could be another reason why ProDOS 
seems to be having protAems with weak power 
sup0es white DOS 3.3 isn t 

In addition to the Jameco supply mentioned in 
Pattersons letter, there are two other sources of new 
power supplies thati am aware of. One isyour Apple 
dealer, who will exchange a rebuilt power supply for 
your old one at a price approximately double what 
Jamco is asking. 



The other source is Applied Engineering (P.O. Box 
798, Carrollton, Texas 75006 214-241-6060), which 
hasstarted selling a heavy-duty replacement power 
supply for $69. Applied Engineering's ads for the 
new supply make it clear that most machines with all 
slots filled have probably reached the limits of 
Apple's +5V line. 

(Based on ^Iverman's mtlde, AC'S ad spears 
reasonable, though the only memory card Silvernmn 
tested back in 1980 was Apple's 16l{ language card. 
It drew .168 amps on the -^SVlbie, A£ rates its own 1 
megabyte RAMworks II at .4 amps and ' typical'' 1 
meg cards at 11 amps. AE's estimates for things like 
clocks and printer interfaces appear a little high 
compared to Silverman's figures, but these items 
draw relatively litUe power compared to memory 
cards, speed-up cards, and disk interfaces, most of 
which weren't auailable to Siluerman.) 

Applied Engineering's replacement power supply 
prouides 6 amps on +5\^ 2,5 amps on +12V, and 1 
amp on -12V and -5V. The Mtermtttant ratings and 
total wattage weren't auzu^le when we asked. As 
input the supply accepts either 90 to 155 AC volts at 
60 hertz, or 180 to 270 uolts at 50 hertz. 

Another possibility, for the hacker types among 
you, is to get a hand-me-down /BM-compatible 
power supply. You'll haue to change the connector 
and it won't fit inside the Apple II case, but the 
standard IBM power supply is heauy-duty compared 
to the Apple fl's. You may be able to find such 
supplies at a good price because many IBMers had 
to replace their standard supply with a more powerful 
one in order to add a hard disk drive. 

A /inai note: Apple hasn't yet notified dealer 
technicians of the power supply/track crash prob- 
lem. One would hope that/^pierepiacesail defective 
power supplies at no cost, j^parently they haven't 
yet figured out how to tell ijt^ether a power supply is 
defective or not however. For the time being, don't 
expect your dealer s technicians to know as much 
about this problem as you do. 

Is 300 baud dead? 

Do you feel that 1200 baud is becoming the 
standard — that anyone who buys a 300-baud unit is 
wasting his or her money? ! have been offered a 
(functioning) 1983 vintage Hayes MicroModem lie, 
but with prices of 1200 baud units dropping (ever so 
slowly), perhaps it is better to wait Obviousty this is a 
personal thing, but I'd rather seek some advice than 
none at all. 

Gerald Fotkin 
StCharies,llL 

Prices for 1200 baud modems are indeed creeping 
downward, but seem to haoe stabilized at about the 
$200-$400 range for now. 

In calculating the price for a modem, remember to 
add up ALL the costs of the modem hardware. For an 
internal type, like the Hayes nimmmdem, usually 
you only need the modem. 

Most 1200 baud modems for the Apple are external 
types, however, like the fiayes Smartmodem. Cer- 
metek, Prometheus, and novation make internal 
modems for the Apple II. The internal modems are 
usually more expensive, but the external types 
require you to buy a serial card and, usually, a cable 
to connect the interfm card and the modem together. 
Expect your minimum investmerU, to be about $500, 
with the opportunity to spend more. 

in the face of this, an economical 300 baud 
modem may be a good investment for smerd 
reasons. 



nrst, you don't put yourself into severe debt while 
finding out if you really want to become a telecom- 
munications junkie. I bought a liayes Micromodem 
and a subscription to the Source the day I bought my 
first Apple 11 (no disk drives, printer, or software, but 
by golly, I was online). However, I never used it 
enough to aave more speed until I started sending 
this newsletter to a typesetter over the phone. (That 
takes the better pari of an hour at 300 baud.) 

Second, if the things ipu want to do with a modem 
uAH happen while you are connected, 500 baud is a 
nice reading speed. The words kind of fly by at 1200. 
Thus, if you are going to read the material as it 
comes in (rather than quickly downloading some 
stuff and reading later), there's little advantage to 
1200 baud. Consider how much of your "connect 
time" will actually be spent transmitting data, as 
opposed to how much will be spent reading, consid- 
ering, attending to distractions, and typing. 

Since many of the big commerical systems haue a 
higher dollar-per-mlnute charge for 1200 baud 
users, it can actually be cheaper to sign onto these 
systems at 500 baud if you intend to read what 
comes in while you are connected. The speed of 
1200 baud will offset the higher 1200 baud cost If 
[^ou are spending most of your time transferring 
data, but if you are reading nwit and haue to stop 
every few lines to catch up, 300 baud is cheaper arid 
just about as efficient 

finally, 1200 baud may not always be usable. 
Depending on the condition of the phone lines in 
your area and other factors such as the phase of the 
moon, you can find some trash creeping into your 
1200 baud commumcation line. Slowing down to 
500 is often the solution to making things readable 

So maybe 500 baud isn't a bad place to start. 
Ifoweuer, if you are serious about telecommunka-^ 
tions, or if you have a lot of data to transfer, then the 
extra cost of a 1200 baud set-up may bejustifiaMe. 
While 1200 baud does seem to be rapidly emerging 
as the standard telecommunications speed, 300 
baud is universally supported, too. 

How, to make you crazy —part of the reason 1200 
baud modems are dropping in price is that 2400 
baud modems are out and getting cheaper. Maybe 
you should start at 500 and switch to 2400 later. Or 
maybe wait for 2400 to come down a bit more and 
start there. Or maybe ...but dedde soon — less e^pen- 
sive 4800 baud modems are already under 
deuelopment. 

Making quit reboot 

Is there a way to patch ProDOS, BASICSYSTEM, or 
any file to cause BASICSYSTEM to reboot upon exit 
(instead of prompting for a new prefix and pathname)? 

Tommy Durham 
SpartanbuTg,S£» 

One solution to your problem is to use a "program 
selector." This is a program that runs automatically 
when you exit a ProDOS program fit replaces the 
"new prefvc/pathname" prompt). It allows you to 
choose what you want to execute next from a menu. 

I've been using Glen Bredon's FroSel and I am 
conuinced it is far superior to the other two widely- 
available program selectors, MomeDesk and Cata- 
lyst. Bredon has continued to enhance his program 
- he recently added DOS 3.3 support and raised the 
price to $40 (see March, page 2.10, 'Don't try to sort 
ProDOS directories" for a more complete description 
of the program ami what comes with it— 521 State 
Rd, Princeton, fiJ 08540). 
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A program selector replaces the quit code " that is 
contained within ProDOS at $D100 of bank 2 of 
^mguage card memory, TNs aide is invoked by the 
FroDOSMU WTcaH—allFroDOS^^emprograms 
are^x^x)sedtoendbymaldr^tNscalLFbrexan^e, 
from Basicsystem, t^EYEto inooke the quit code. 

The built-in ProDOS quit code prompts you for a 
prefix and pathname for the next applicsdion you 
want to run. This is fine, unless you want to run 
something using Apple /^asc^, CP/M, or DOS 5.3, 
which makes the quit code seem awfuUy stupid for 
allowing only FroDOS responses. 

I assume this is your mMmtion for asf^ng for a 
Reboot" option. 

WUhProDOS ill (the ueraion number is imporimtlh 
a short patch will cause the ^stem to automMicaily 
boot when the quit code is activated: 

eiOflO PRDOOS,fl$2M0JSYS 

CALL-lSl ^ 

512D:CE F2 83 6C Ft FF 5"7ZD- CC f^f 0S 

3DdG 

UNLOCK PRQDOS 

flSflVE pRoDos^flszeaevtttSfie-jsYs 

iOCK PRODOS ^ ^ 

The machinecodetmi^l3^asDEC$5n^ollowed 
by JMP ($FITi); the first instruction sets the power- 
upbytesothattheJ^pleuMlrd)0(^whenaHESETis 
executed, thesemndinstmdUonexecutes^el^ET 

cycle. 

This is not very user-friendly (type BYE and boom 
—the system reboots without warning), but uM 
work. 

Because the unmodified quit code points the 
RESET vector at itself there is no way to force a boot 
without patching the quit code. Decrementing the 
power-up byte before callir^ quit and then pressing 
reset doesn't work— you merely get that lovely 
prefix prompt back again. On an ^ple //-Hus, which 
doesn'tsi^port Uie open-3^le-control-reset reboot 
the only way to stmt a disk from another operating 
system is to power down and i>acfc i^. IWiat a pain in 
tiiediips. 



AppleWorks lock up 



Why does AppleWoiiss lock up when I delete a 
report format? It is most annoying and could be 
anything, as my He sports a replaced motherboard 
(modem upgrade), which I don't trust at al) {the outfit 
that did the upgrade just folded!), and a 512K Z-RAM, 
which I always suspect of adding its own particular 
confusion to everyttiing else. 

This may be old hat to many AppleWorks users, but 
here's a little convenience I've found when creating a 
data base — 1 create a bunch of exfra categories with 
blank names and just leave them bunched-up down 
in the bottom right comer of the record —then if 1 
want to add categories at a later date, 1 can march 
them out into the ia^ut and open-apple-n(ame) 
them without having to redo the entire layout and 
without losing any report formats. This saves a lot of 
time and keeps things flexible. 

DanSdfert 
St Paul, Minn 

Tve also had AppleWorks seem to lock-up while 
deleting a report format Howevei I'm now starting 
to wonder whether I didn't wait long enough. Apple- 
y\!orks takes an unbearably long time to remove files 
from an expanded desktop— maybe Uils applies to 
report formats, too. Whenever AppleWorks seems to 
lock iq) itisprobahly worUuvhile to give it some time 
—at least five minutes— to see if it is resdly "just 
linking" 



J can't think of any good reason not to design ail 
data base files with the full 50 possUHe categories, 
just as you suggest The fUe wiU be slightly larger if 
you do this, but with an ejq>anded desktop the small 

increase in size will be of little consequence. 

AppleWorks page nos. (cont) 

According to our sources at Apple, AppleWorks 
numbers pages from 1 to 255, then starts over from 
zero. 1 guess they didn't anticipate the effects of 
memory expansion. There's no easy trick to fix this 
other than the obvious: breaking up the document 
Apple says that it is aware of the problem and that 
Rupert [jssner has already fixed it The fix will appear 
in their next release... who knows when? 

Christopher Van Buren 
Q-marOroup 
P.O. Box 11215 

bC fC FF San Diego, Calif. 92111 

The Q-mar group publishes a monthly newsletter 
dedicated to AppleWorks cedled AppleWorks Exdw 
sioe Reference. Subscriptions are $59.95 mthe U.S. 
and Canada 

System Utilities bugs 

Apple has released the UniDisk 3.5 system utilities 
package on a 5-1/4 inch disk. Its available, with an 
updated version of the ProDOS Users Disk on the 
back, under the name Apple U Utilities Guide 
(A2D20S5.m-Apple 11^^ t/tttities, A2D2054, 
is the 3.5 version of this package; it comes with the 
UniDisk 3.5). 

On the AISERS.DISK side of the disk, COnVERT is 
updated to bypass ttie MouseText characters. I don't 
know if any other fixes have been applied. Otherwise, 
FRODOS, BAS1C.SYSTEM and FlIXR are from the 
version U and subsequent HI updates. The CHAiri 
problem has not been fixed. 

On the /UTILITIES side of the disk, we have both 
the He and lie versions of the system utilities package 
that originated with the He l^e programs are nice, 
but very slow. They work witti ProDOS, Pascal DOS 
3.2, and DOS 3.3 diskettes. 

The COPY function is the most interesting. It allows 
file copying between these operating systems. Well, 
anyway, some limited file copying. I have successfully 
copied a text file fi'om ProDOS to Pascal to DOS 3.3 
and back to ProDOS. The file arrived back and 
matched the file that was sent There were some 
small glitches. 

When copying the 76-byle file firom ProDOS to 
Pascal, two extra blocks were added (at the end; I 
have already taken into account the two-block Pascal 
text header). By the time I got to DOS 3.3, the file had 
X024 extra bytes of zeros tacked onto it (five extra 
sectors). The opposite directk>n had more difficulties. 

ProDOS to DOS 3.3 went OK, but DOS 3.3 to Pascal 
had two bugs. The file increased In size fi-om five DOS 
3.3 sectors to 6 Pascal blocks (same output size as 
from ProDOS to Pascal). However, the file name was 
stored in the Pascal directoiy with high bits set {"A" as 
$C1 instead of $41). Thus, a Pascal program could 
not find the file. In addition, when going from DOS 3.3 
to Pascal, 35 bytes of text were chopped off at the 
beginning of the text The chopped file anrived back at 
ProDOS just minus the 35 bytes (no extra blocks). 

Bigger problems arise when attempting to convert 
a Pascal program source file to ProDOS. The utility 
cannot handle the Pascal editor's special control- 
codes and occasionally aashes into the Monitor. At 
other times, the file converts, but loses some data 



and gets other data records out of order. 

The documentation is poor in that it does not 
describe the file conversion process. It does not 
indicate what file types can be converted properly. It 
will not convert a BiM file to Pascal. So what is left? 

What I wanted mostly was documentation of the 
ampersand routines the program uses and which 
have been discussed in Open-Apple. Ho such luck. 

I have written to Apple about these problems (Tell 
Apple About PO. Box 1143). They also got a big stack 
of file dumps, block dumps, and directoiy listings to 
support the bugs. 

My Apple dealer just informed me that MousePaint 
Version 12 is being made available to MousePaint 
owners. I obtained the update. I had version 11 which 
was dated March 1984. 1 bought my Mouse in January 
1985. Version 12 is dated April 1984. Ouch! Double 
ouch!! What gives? Why does it take Apple Computer 
two years to put out an updated version that was 
rcacty two years ago? This sort of thing is a real 
downer- 
Ken Kashmarek 
Eldridge, Iowa 

IfCOnVEKT, Flint, andtheSystem Utmesareany 
exampte we can assume Apple did not spend two 
years in testing the produd. 

I have rapidly become addicted to the new ProDOS 
ver^on of Copy 11 Plus (March page 210) and now 
use it exclusively for file manipulations. It is vastly 
superior to Apple's own system software. It can 
convert any type of file, including random access 
flies, between DOS 5.5 and ProDOS. It doesn't 
hmdle Pascal disks, however. 

Inddentally, according to the April 21 Infoliyotid 
(page 14), Apple has taken legal action to prevent 
further imports of the Laser 128 Apple-compatible 
computer that Central Point has been selling. Apple 
claims both copyright and patent infringments. 

Joyful programming 

Help! How do 1 program my Apple He to use a 
joystick instead of a keyboard? 

Charles Besari 
OrtonvillcMich, 

The Apple keyboard and joystick are separate 
devices. In your own Applesoft programs, you read 
the keyboard with IFiPirrorGET. You readajoi^tid^'s 
poslUon using the Api^esoft PDL function. The 
position ofajoystick's pushbuttons can be detected 
byimOng: 

10 X = PDL(e) : REM X axis (0 to 255} 

20 Y = P0L(1} : REM Y axis (0 to 255) 

30 Bl = (PEEK( -16287] > 127) : REM button 

40 B2 = (PEEK (-16286) > 127) : REM button 1 

Bl and B2 uAU be set to if the button is up or to 1^ 
the button is pressed (or, on a Il-Pius, if noMng is 
connected to the game I/O connector). 

Further information is available in The Apples^ 
lUtoiisd and The Applesoft Bask Programmer's 
Reference iVamial, as well as in many other books 
on Applesoft There are also ways to do this in 
machine language and Apple Pascal. 

In commercial programs that are not user- 
modifiable, you are limited to use of the keyboard 
Mn/css the program includes a pystick option 

Another fast garbage trick 

In the Januaiy '85 Open-Apple (page 4-5) you 
described a technique for repeatedly poking TRETOP 
to eliminate garbage collection. While this works well. 
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it requires some finesse on the part of ttie programmer 
to know when to poke FRETOP. If most of the strings 
the program uses are truly constants then an easier 
way is available. 

rirst DIM and load all constant string arrays and 
simple string variables. Execute an X=FRE{0) com- 
mand, then set MIMCM: equal to the contents of 
FRETOP like this filMEN:FEEf{(lll) + 256*FEEn(ml 
That's all! The garbage collection routine will not 
move these constant strings, as they will always 
appear to have already been moved. 

Conscientious programmers would put a HI MEM: 
or MAXFILES command on the first line of their 
program to recoup memory on multiple RUIis. For 
example: 

1 PRINT CHRI(4);''t1flXriLE5 3" : REM reset HIMEM 
10 : 

100 DIM BIG$(500} : D$= CHR${4) : REM constants 
110 : 

120 REM read in the permanent strings from disk 



1G0 X = FRE[0] : REM pack in the neu strings 
170 HIMEM:PEEK(111) + 256«PEEK(112) : 

REM set HIMEM to value in FRETOP 
180 REM all strings and string arrays created 

past this point will be collected norfnaliy. 

If you change the value of a string defined before 
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line 170, it will move outside the permanent storage 
area, so make sure all strings defined before line 170 
are strings you do not intend to change. 

FVank Q.Andrews 
Kalamazoo, Mich, 

To heip people understand how this tiick works, 
let me remind them why the Applesoft garbage 
collector is slow. For each string variable you use, it 
must look at all string variables once. Thus, the more 
variables you have, the longer it takes to look 
through all variables, and the more times it has to be 
done. 

With this tricK you hide" your permanent variables 
so that the garbage collector doesn't make passes 
for them. When the collector makes passes for your 
unhidden" variables, however, it still must look 
through ail variables, both the hidden and unhidden 
ones. This trick works best, then, when you have just 
a few temporary, unhidden strings. 

The more complicated trick explained in the January 
'85 Open-Apple tries to avoid garbage collection 
entirely. The trick given here allows collection to 
occur when necessary, but tries to fvc things so that it 
happens so quickly that no one notices. 

SU2.0BJ bug found 

All the correspondence that has appeared in 
Open-i4pplc regarding the SU2.0BJ routine from the 
System Utilities disk has aroused my curiosity 
(December, page 96; March, page 213-14). Enough, in 
fact, that I have dug into the routine to figure out how 
it works, and along the way I've found a few surprises 
and I've squashed the bug in afiriPUT. 

My lie {purchased in late 1985) apparently came 
with the new version of SU2.0BJ that supports the 
UniDisk 3.5, even though my lie itself does not 
Although my System Utilities disk sets HIMEM:32256 
($7E00) before BRUNning SU2.0BJ, and the routine 
itself doesn't change this, it works equally well if you 
use HIMEM:34560 ($8700) instead. The lowest memoiy 
location it uses is $8BD6. Since HIMEM in ProDOS 
must sit on a page boundiy ($xx00), you might think 
that $8B00 would work. But it doesnX because 
ProDOS puts its first file buffer in the four pages 
starting at HIMEM. Therefore, HIMEM must be set four 
pages below the lowest address used by the routine. 
The System Utilities' use of $7E00 implies that 
everything above $8200 is used by the program. If it 
is, it isn't l)ecause of SU2.0BJ, so your own programs 
that take advantage of it can use $8700 instead. 

Besides fif IftPUT, SfQET, SfPRIffT, and SfEXIT, SU2.0BJ 
also includes an SfHTAB command. If you want to 
SfPRINT something at a screen location other than 
column X you need fieHTAB instead of the normal 
HTAB. Whereas SfHTAB works for both PRINT and 
arPRINX the normal HTAB does not 

Everything that you SflNPUT or fifPRIFIT passes 
through a 160 character buffer located at the end of 
SU2.0BJ itself. Code that initializes the routine gets 
overwritten with the first use of either of these 
commands. This limits the &mPUTted or fifPRINTed 
stuff to 160 characters. Worst of all, the routine itself 
doesn't check for overflow, so everything in excess of 
160 characters will merrily overwrite the ProDOS 
code starting at $9A00. The programmer must be 
veiy careful not to SfPRIMT anything longer than the 
buffer. Apparently fifPRIHT was designed to print 
strings that might extend as far as two 80-column 
lines, but no more. fifPRINTs primary purpose is for 
printing lines that are compatible with both the 40- 
column and 80-column screens (fifPRINT checks 



what mode your Apple is in and provides wtHd-wrap 
at the appropriate point). 

Mow, for that elusive bug in SflFIPUT — as Christoper 
Hogue pointed out in the March issue, the first 
character of the string often gets clobbered. But the 
affected string isn't the one received by SflNPUT, ifs 
the one that was entered just before SflMPUT was 
used! This happens because flfinPUT copies one too 
many characters from its buffer to Applesoft's string 
storage area. The excess character can be a fill 
character as defined by FL$ (if the field indicated by 
fill characters was completely used) or a space (if it 
was not). Where Hogue's strings appeared to be 
missing the first character, it was because the first 
character had been replaced by a space. The very last 
staing entered will always be undamaged because 
fifinPUT hasn't yet had the opportunity to clobber it 

In my version of SU2.0BJ, the code responsible for 
moving the sting data into the string storage area 
resides at $974E and looks like this: 



974E: 


m 


00 


LDY 


«$00 


Get length from string 


9750: 


Bl 


83 


LDfl 


($83, Y) 


descriptor 


3752: 


BD 


EG BB 


STfl 


$8BEG 


Sav^s length in data area 


3755: 


EE 


EG 88 


INC 


$8BEG 


fidd 1 (WHY??!!!) 


375B: 


C8 




INV 






9759: 


81 


83 


LOR 


($83, Y) 


Get iou byte of string 


3758: 


85 


FE 


STR 


IFE 


pointer, put at IFE 


975D: 


CB 




INY 






375E: 


Bl 


83 


LOR 


($83, Y) 


Get high byte of string 


37G0: 


85 


FF 


STfl 


$FF 


pointer, put at $FF 


3762: 




00 


LOY 


tt$00 


Start with character 


9754: 


CC 


EG BB 


CPY 


$8BEG 


all copied? 


37G7: 


F0 


03 


BEQ 


$3772 


yes, branch to RTS 


37G9: 


89 


G0 39 


LDfl 


$36G0,Y 


no, fetch next and 


37GC: 


31 


FE 


STfl 


($FE),Y 


copy it 


37GE: 


ca 




INY 




Set Y for next char 


g7SF: 


4C 


64 97 


jup 


$97G4 


loop back 


9772: 


G0 




RTS 







The bug occurs at $9755. Increasing the length by 
1 makes an extra character get copied from the 
buffer to the string storage area, overwriting the first 
character of the previously-defined string. Since ttie 
entire buffer initially gets filled with FL$, then gets 
filled up to position FL with spaces if the entered 
string was less than FL characters long, this extra 
character can be a fill character or a space depending 
on whether or not the entered string filled the field. 

To fix the bug requires only that we NOP out 
(replace with $EA's) the three bytes starting at $9755. 
To make this permanent requires a little detective 
work, since the SU2.0BJ code isn't BLOADED to its 
ultimate operating location but is moved there 
during initialization. In the version I have, SU2.0BJ 
loads in at $2000, where it immediately moves code 
from $203B through $2E64 to locations $8BD6 
through $99FF. This means the string-moving sub- 
routine (listed above) begins life at $2BB3, and the 
offending three bytes are at $2BBA. To fix it just 
BLOAD SU2.0BJ, verify that $2BBA$2BBC contains 
EE E6 8B, change those bytes to EA EA EA, and BSAVE 
SU2.0BJ. You don't need to specify the A and L 
parameters because ProDOS will use the values 
shown in the directory. If your version doesn't have EE 
E6 8B at $2BBA, youll have to go searching for it 

Have fun with SU2.0BJ and be sure to observe the 
160 character limit This routine has no mercy and 
will gladty send ProDOS off into never-never land if 
you let it And thanks to Christopher Hogue for 
revealing a most useftil and interesting routine. 

Clay Ruth 
Dyer, Ind 

In the original lie version of SV2.0BJ, the three 
offending bytes appear at $2DAr'$2DBl 



